____________________
Install Instructions
--------------------
1) Download the latest PAM UO zip file from www.garetgg.com (you probably already did that if you are reading this).

2) Make sure the Zip file contains:
  z_svr_pamuo_<version>.pk3 file
  PAM UO install instructions.txt (this file!)
  HLC_RCON install instructions.txt
  9 x HLC_RCON config files
  Example PUB config file for S&D
  Example PUB config file for CTF
  Suggested PUB PB Config File

3) Upload the .pk3 file to your server in the uo/ directory.

4) Stop your server.

5) Remove any old versions of PAM UO and any other mods that may be installed.

6) Restart your server.


OPTIONAL HLCRCON: If you would like to use the HLC_RCON included with PAM UO, at this point you should read and follow the instructions found in the HLC_RCON_Instructions.txt file.  PLEASE NOTE!! YOU DO NOT HAVE TO USE HLC_RCON! IT IS COMPLETELY OPTIONAL.


OPTIONAL PUB PB CONFIG: The following instrcutions are if you would like for PAM UO to automaticly exec a PUB PB Config file when you switch into PUB mode from any other mode.
1) Remove the pub_pbsv.cfg file from the ZIP file.

2) Edit this pub_pbsv.cfg file to your liking, but DO NOT change the name of the file.

3) Upload the pub_pbsv.cfg file you edited directly to your server's uo/ directory.  DO NOT TRY TO PUT THIS FILE IN THE PAM UO PK3 FILE.



************************
----- Change Log -------
************************

____________
3.2b Changes
------------
1) Fixed PUB-mode problem where the gametypes would not start correctly if you did not have the optional PUB_PB config file installed.
2) Modifies some league rules.

___________
3.2 Changes
-----------
1) Fixed a bug in new DOM scoring that was causing the flag intervals to not reset when it was captured by the other team and immediately re-captured.
2) Added some script to hopefully prevent double-ready-ups from occuring (where a player keeps getting multiple 'ready-not ready' notices while trying to ready-up)
3) Added PUB mode feature- Force Client Rate (scr_force_client_rate):  This cvar can be set on the server to force the client rate to the specified value.  Set this cvar to 25000 to force all player's rates to 25000 every few seconds.  Setting this cvar to 0 turns this feature off.
4) Added PUB mode feature- Empty Server Map Rotator (scr_empty_server_maprotate): It will allow you to specify a number (in minutes - min:5 - max:60) that an empty server will sit before rotating automaticly. This will override roundlengths in long gametypes such as CTF and BAS so that (if it is empty) the server will keep on rotating.
   -If even 1 person is on the server or joins the server the timer does not count.
   -If 1 person JOINS the server, it will reset the timer to 0. 
   -If everyone leaves the server during a map, the timer will start within 60 seconds of everyone leaving.
5) Added PUB mode feature- Automatic AFK Monitor (scr_afk_limit): This cvar will set the ammount of time (in seconds) a player is allowed to stay in the same spot before assuming the player is AFK.  If a player has been determined to be AFK, he will automaticly be moved into spectate.  It WILL warn the player that he/she is about to get moved about 10-15 seconds before it does it to give those ULTIMATE campers out there a chance to register some movement.  Please note that rotational movement does NOT count, only the player's x-y coordinates on the map.
6) Added PUB mode feature- Automatic TK Monitor & Temp Ban Tool (scr_tk_limit): This cvar allows you to set a TK limit on your server.  Each TK up to the limit, the server will automaticly warn the TKer that they have 'x' number of TKs left before they are dealt with.  If the TKer REACHES the TK limit, PAM UO will use PB (if it is enabled) to kick and ban the player for 3 minutes. If PB is not enabled this will NOT work at all.  The TK counter restarts each map.
7) Fixed an exploit in DOM where a player could call an Arty Strike on the other team's spawn just before an All Cap Map-Reset and cause major problems.
8) Integrated Automatic execution of PB Config Files for supported leagues with published PB config files.  This will get run BEFORE the 1st half ready-up starts.  IT WILL CAUSE LAG WHILE THE PB CONFIG IS LOADING!
9) Added PUB mode feature- Admins can now run script-checks on suspicious players to see if they are using any scripts. Usage from rcon:
\rcon g_scriptsearch <player slot>
The player's slot can be gotten by doing an "\rcon status". NOTE THIS IS NOT THE PB PLAYER NUMBER! YOU MUST SUBTRACT ONE FROM THE PB PLAYER NUMBER TO GET THE PLAYER SLOT.
10) Automatic Script Checks (for PUB or Match Modes)- If a league choosed to disallow the use of scripts they can use the following cvars: pam_pb_scriptchecker & pam_pb_scriptcheck_timer.  Note that this will detect ALL PLAYER'S THAT HAVE BINDS WITH THE FOLLOWING STRINGS ANYWHERE IN THEM: ";", "exec", and "vstr".  

Plase note that just because a BIND is found does not mean it is a cheat bind, however both the cheat and the innocent binds will be recorded to your server's pb log file for review.

pam_pb_scriptchecker
0 = off, no automatic script checking
1 = one-time check just before the first round starts or as the players enter the server if they come in later
2 = same as 1, except random checks are made on players at an interval determined by the pam_pb_scriptcheck_timer cvar

pam_pb_scriptcheck_timer
set in seconds (minimum 30, maximum 300).  When this time period hits, one random player will be chosen and be checked for script usage.  The last 3 players checked are exempt from the random draw.

11) Automatic PB Log File Change (for matches only)- At the beginning of each map PAM UO will automatically increment the PB log file if you are in a match mode. It will also change the log file at the END of a map.  When the log file is changed, PB will automatically tell all players the name of the log file and the MD5 value of the file.

12) TWL PAM MODE NAME CHANGES-
S&D & CTF:
"twl_rifles" --> "twl_rifles_ladder" or "twl_rifles_league"

TDM:
"twl" --> "twl_4v4" or "twl_6v6"

13) ClanBase Rule File Change:  I have removed the sv_SniperLimit cvar from all ClanBase rule files since it is optional for matches.  This means that this cvar needs to be set correctly BEFORE a match begins.
14) Added ClanBase support for BAS gametype (pam_mode "cb")
15) Weapon Limits Bug Fix- Weapon Limits was counting the currently USED weapon (not the weapon selected in the menu) AND it was counting weapons being used by the other team (i.e. it was counting the Axis sniper rifles captured and being used by Allies against the Axis limit).



____________
3.11 Changes
------------
1) Fixed several small crashes pertaining to weapon limits and the newly supported gametypes (HQ, BAS, DOM).
2) Added an option for 'Players Alive' display for CTF.
3) PAM UO now tells players at ready-up if they are on Team1 or Team2.


___________
3.1 Changes
-----------
1) Fixed TDM bug with TK and suicides not counting against the team.
2) Fixed TDM issue where the map was not resetting before the first round started.
3) Auto-Demo gone for good (or until GWI patches their bug).  Too many people still having problems with it. SCRIM modes gone too, no longer need for them.
4) DOM Gametype Scoring Mod integrated to be fully supported by PAM UO. Needs testing.
5) Fixed a bug where someone can start the 2nd half in S&D with a 'dead' status icon.
6) Fixed TDM issue where deaths were being counted on the player's score while a match is not live.
7) Fixed a S&D issue in PUB mode where player's could score before the first round started and keep the score.
8) Added PUB support for the DM gametype. Wepaon limits, message center, tank limits, etc now work for DM.
9) Added partial support for BAS & HQ gametype.  Match modes now have ready-up periods and rule files which automatically setup the cvars on the server for that league/ladder.  Also included are weapon limits, tank limits, and PUB mode support for the message center, server admin tools, etc.
10) Re-worked Weapon Limit script for better optimization.  
11) Changed the Weapon Limits script such that weapon limit cvars set to 0 or 99 will DISABLE the wepaon limit checks altogether.
12) IMPORTANT NOTICE! CVAR CHANGES!!!  Combined Axis/Allied Weapon Limit Cvars into one cvar. For example, sv_alliedSniperLimit and sv_axisSniperLimit have been combined to just sv_SniperLimit.  Same is true for ALL weapon limit cvars.
13) Integrated HLC RCON V5.2.  its use is COMPLETELY OPTIONAL.
14) Prevent maps from rotating after they end in all match modes.
15) IMPORTANT NOTICE! CVAR CHANGES!!!  To make multi-gametype rotations work together better, I have renamed the following cvars to make them gametype specific:
  scr_half_time
  scr_half_round
  scr_half_score
  scr_end_round
  scr_end_score
  scr_end_half2score
  scr_count_draws

  These are all now scr_{gametype}_{variable}.  For example, scr_half_round for S&D is now scr_sd_half_round.

16) Fixed the CTF persistant scoreboard so it is READABLE! lol.
17) Added Halftime spammage for TWL modes.
-------------------------------------------



PAM UO V3.01
+ Fixed a crash bug that would happen if you FORCED Overtime to come on by setting g_ot_active 1.  It is now possible to force OT if necessary.

+ Inserted default set of rules for the DOM Scoring Mod (in case none were set up). PAM UO IS NOT TO BE ENABLED FOR DOMINATION MATCHES!!!!

+ Changed TWL Ladder S&D rulesets to end at 20 rounds and go into a 1 round OT.
-------------------------------------------

PAM UO V3

IMPORTANT CHANGE:
PAM UO will AUTOMATICALLY load a new map once enabled or disabled.  This is done to FULLY prevent the "CL_GETSERVERCOMMAND: A reliable command was cycled out" error that occasionally occured in PAM UO.

If you are enabling or disablinb PAM UO in a config file, set the "svr_pamenable" cvar LAST and do not call for a map_rotate. Allow PAM UO to switch maps on its own, after the map switch you can do a map_rotate to get back on your map_rotation.  

EXCEPTION:
If you server is not currently running when your config is run (for example the start-up config file), then you will still need a map_rotate or map call command in your config.


MAJOR Changes:
+Complete Script Revision on Ready-Up to solve the 'Stuck in Ready-Up' issues. If you get stuck in Ready-Up, this can be remedied by having ANY player on the server un-ready-up and re-readying-up.


+PAM ENABLE has been changed. svr_pamenable will now AUTOMATICALLY cause a new map to load (either foy or italy). This will COMPLETELY prevent the "CL_GETSERVERCOMMAND: A reliable command was cycled out" error that occasionally occured in PAM UO when the map was not changed after enabling or disabling PAM UO.

The exception to this is if your server is not currently RUNNING, or is not running in a supported gametype (CTF, S&D, or TDM).


+Automatic Map Restart on change of PAM Modes. The server will announce the change of PAM modes and automaticly restart the map for you. If the PAM mode is not recognized as being valid (for the current gametype), it will warn that the PAM mode was not recognized as being valid, but it will NOT restart the map. If you restart the map on your own, it will go into PUB mode.


+Auto-Demos are back. I have included script that should prevent the auto-demo function from being called on a player more than once per map. Essentially, I stop all demos recording at the beginning of a map (or as players join), then start a new one. But once the new one has started, Auto-Demo will not be called on that player again until he either leaves/re-joins, a map_restart is done, or the map changes.


+Visual que as to which players are ready or not. I have removed the screen-spamming "Waiting on such and such player" every 10 or so seconds since you can now see on the scoreboard who has/has not readied-up.


+PUB admin commands have been added to help admin your server (no, these will NOT work in match modes):
\rcon set g_switchteam [player #, or "all"] (Forces the identified player to the opposite team from what he is on, 'all' will swap all players)

\rcon set g_switchspec [player #] (For those annoying AFK player problems, but you don't want to kick the player, force him to Spectate)

\rcon set g_killplayer [player #] (Use this wisely... abuse it and you will end up with a very unpopular server)

Note: [player #] can be found by using the status command on the server:
\rcon status


Bug fixes:
+Fixed TDM so that a map_reset is done after the 2nd half ready-up (resets vehicles, dropped weapons, and such)
+Fixed TDM so that kills before a match start and after regulation time do not count towards scoring.
+Fixed TDM so that the 'Stock' End-of-Map Scoreboard reports the score correctly.
+Solved VEH_unlink problem, players in vehicles at the time of the automated team switch will be suicided.
+Fixed Bugs in the STOCK mp_peaks and mp_streets map scripts. Peaks now uses the correct uniforms for Americans.
+Fixed a very rare bug that could crash the server if a player was kicked from a server just before a tank is destroyed if that player was in that tank.
+The Ready-up script revision fixes crashes that were happening on servers during ready-ups with players that took a very, very long time to load and join maps.

Other changes:
+scr_allow_grenades now also prevents the nade spawns on Ponyri.
+Added a cvar (scr_allow_jeep_gunner) that can be used to disable the mountable guns on the jeeps.
+Added a cvar (scr_allow_mg42) that can be used to remove the stationary MG42s from maps.
+Added cb mode for TDM (clanbase)
+Added scr_selfDestructJeepTime, scr_selfDestructTankTime cvars to rule files; These set the amount of time a vehicle sits after being used before it blows up on its own.
+Added scr_force_bolt_rifles cvar. If on:
   Russians will be forced to take the Nagant
   Germans will be forced to take the Kar98
   British will be forced to take the Enfield
   Americans will be either the Kar98 or Nagant, which one depends on whether the map scripting allows Russian sounds
